The table below summarizes the most essential elements of a Selerix Transmittal XML involved with a BenSelect enrollment integration as described in Web Services Basic Instructions. Information in the table reflects the structure of the transmittal XML.
Root Element Name |
Child Element Name |
Child Element Name |
Child Element Name |
Type |
Examples/Notes |
SenderID |
GUID |
New ID generated at runtime. |
|||
PortfolioID |
GUID |
ID from Portfolio Report that identifies the enrollment group. |
|||
Type |
TransmittalType |
Defines how BenSelect will interpret the transmittal; the purpose. See reference. |
|||
Group |
Class |
Note that a Group container must exist in the output XML even if none of the members of the Group are populated. If absent, BenSelect returns an error. |
|||
Applicants |
Collection |
Employee(s) and dependent(s) applicants. |
|||
Applicant |
|
Class |
Serialized representation of a single applicant. |
||
Relationship |
Enumeration |
Employee, Spouse, Child, etc.. See reference. |
|||
ID |
GUID |
Value used to relate employee with dependents. Set to same value for all applicants in the family. |
|||
EmployeeIdent |
String |
Option 1 identifies the employee to enroll. Same as EID in the Employees page of the BenSelect administration site. |
|||
SSN |
String |
Option 2 identifies the employee to enroll. |
|||
FirstName |
String |
Option 3 identifies the employee to enroll. All members of option 3 must be included. |
|||
LastName |
String |
Option 3 identifies the employee to enroll. |
|||
BirthDate |
DateTime |
Option 3 identifies the employee to enroll. Employee's date of birth. |
|||
Employment |
|
Class |
Structure representing a class. Only applies when applicant Relationship is employee. |
||
Department |
String |
Employee's department (required). |
|||
HireDate |
DateTime |
Employee's date of hire (required). |
|||
JobClass |
String |
Employee's job class (required). |
|||
Location |
String |
Employee's location (required). |
|||
DeductionFrequency |
Int32 |
Any of these values may be required by enrollment rules. Check with your group administrator or Selerix to see if required.
This list is just a sample of commonly required fields. |
|||
EligibilityDate |
DateTime |
||||
HoursPerWeek |
Int32 |
||||
PayGroup |
String |
||||
PayrollFrequency |
Int32 |
||||
Salary |
Double |
||||
Address |
|
Class |
Applicant address. Refer to Address class reference for complete member list. |
||
Line1 . . . |
String |
Line1, Line2, City, State, Zip etc.. |
|||
Applicant |
|
Class |
Sample applicant showing required dependent fields (Spouse, Child, etc.). |
||
Relationship |
Enumeration |
Employee, Spouse, Child, etc. |
|||
DependentNumber |
Int32 |
Uniquely identifies the dependent in the family. Typically spouse is set to '1', first child set to '2', and so forth. |
|||
EmployeeID |
String |
Required. Must match value assigned to the employee's 'ID'. |
|||
EmployeeIdent |
String |
If assigned, must match value assigned to the employee's 'EmployeeIdent'. |
|||
FirstName . . . |
String |
Other members such as FirstName, LastName, BirthDate, etc. Refer to Applicant class reference for complete member list. |
|||
Agents |
|
|
Collection |
List of Agents. Usually not required on cases that are built for enrollment integrations in other applications. |
|
Agent |
|
Class |
Serialized representation of a single Agent. |
||
FirstName . . . |
String |
Other members such as FirstName, LastName, Address, StateLicenses, Organization, Split, etc. Refer to Agent class reference for complete member list. |
|||
etc. . . . |
Refer to the Transmittal reference for a complete list of members. Serialized XML structure mirrors class structure. |